package com.xuetang.mapper;

import com.xuetang.entity.DietFood;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 食物信息Mapper接口
 */
public interface DietFoodMapper {

    /**
     * 获取所有食物列表
     * 
     * @return 食物列表
     */
    List<DietFood> listAll();

    /**
     * 分页获取食物列表
     * 
     * @param offset 偏移量
     * @param limit  限制数量
     * @return 食物列表
     */
    List<DietFood> listByPage(@Param("offset") int offset, @Param("limit") int limit);

    /**
     * 根据类别ID分页获取食物列表
     * 
     * @param categoryId 类别ID
     * @param offset     偏移量
     * @param limit      限制数量
     * @return 食物列表
     */
    List<DietFood> listByCategoryId(@Param("categoryId") Integer categoryId, @Param("offset") int offset,
            @Param("limit") int limit);

    /**
     * 搜索食物信息
     * 
     * @param keyword 关键词
     * @param offset  偏移量
     * @param limit   限制数量
     * @return 食物列表
     */
    List<DietFood> search(@Param("keyword") String keyword, @Param("offset") int offset, @Param("limit") int limit);

    /**
     * 根据ID获取食物信息
     * 
     * @param id 食物ID
     * @return 食物信息
     */
    DietFood getById(@Param("id") Integer id);

    /**
     * 新增食物信息
     * 
     * @param food 食物信息
     * @return 影响行数
     */
    int insert(DietFood food);

    /**
     * 更新食物信息
     * 
     * @param food 食物信息
     * @return 影响行数
     */
    int update(DietFood food);

    /**
     * 删除食物信息
     * 
     * @param id 食物ID
     * @return 影响行数
     */
    int delete(@Param("id") Integer id);

    /**
     * 统计总数
     * 
     * @return 食物总数
     */
    int count();

    /**
     * 统计类别下的食物总数
     * 
     * @param categoryId 类别ID
     * @return 该类别下的食物总数
     */
    int countByCategoryId(@Param("categoryId") Integer categoryId);

    /**
     * 统计搜索结果总数
     * 
     * @param keyword 关键词
     * @return 搜索结果总数
     */
    int countByKeyword(@Param("keyword") String keyword);

    /**
     * 获取最近添加的食物
     * 
     * @param limit 限制数量
     * @return 食物列表
     */
    List<DietFood> listRecent(@Param("limit") int limit);
}